Building and Debugging

Building and Debugging

A STREAMS driver or module is a kernel module and is compiled using the same compiler options as any driver (see "Compiling and Linking").

You configure each STREAMS driver or module as part of the IRIX kernel by:

Placing the executable module in /var/sysgen/boot
Writing a descriptive file and placing it in /var/sysgen/master.d (see "Describing the Driver in /var/sysgen/master.d")
Placing a USE or INCLUDE line in /var/sysgen/system (see "Configuring a Kernel")

When a STREAMS driver or module is loadable, you specify the appropriate options in the descriptive file (see "Master File for Loadable Drivers"). You can configure a STREAMS driver or module to be autoregisterd and loaded automatically (see "Registration"). Alternatively, you can require a STREAMS driver or module to be loaded manually using the ml command (see "Loading").

When you have configured a debugging kernel (see "Preparing the System for Debugging"), the symbols of a STREAMS driver or module are available for display. You can set breakpoints using symmon (see "Using symmon"). You can display symbols using symmon or idbg (see "Using idbg"). In particular, idbg has built-in support for displaying the contents of structures used by a STREAMS module or driver (see "Commands to Display STREAMS Structures").